home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / preference programme / systemprefs / systemprefs-e.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  18KB  |  406 lines
  1. @database SystemPrefs.guide
  2. % English version
  3. @width 80
  4. @wordwrap
  5. @Node Main "SystemPrefs: Contents"
  6.         == TriTech Developments Proudly Presents ==
  7.              _     _ ______       _  _  __ __ _
  8.             (_'\\_/(_' | |_ |\\/|  |_)|_)|_ |_ (_'
  9.             ,_) | ,_) | |__|  |  |  | \\|__|  ,_)     V3.4
  10.           - The System Control Preference Editor -
  11.          NEW:   now 68060 and draco compatible  !!!
  12.                   == CONTENTS ==
  13. 1.     @{" Short description    " link Kurz}  about the program
  14. 2.1.   @{" Contact address      " link Address}  of the author
  15. 2.2.   @{" Copyright            " link Copyright}  ! READ IT !
  16. 3.     @{" Installation         " link Install}
  17. 4.1.   @{" CPU Cache Control    " link Cache}  Cache settings
  18. 4.2.   @{" RAMSEY Control       " link Ramsey}  RAMSEY settings
  19. 4.3.   @{" CIA Control          " link CIA}  CIA settings
  20. 4.4.   @{" The menus            " link Menu}
  21. 5.     @{" 60ns-Mode            " link RAM60ns}  When can you use it?
  22. A.1.   @{" FAQ                  " link FAQ}  Troubleshooting
  23. A.2.   @{" Improvements         " link Improve}  What's to come?
  24. A.3.   @{" Known bugs           " link Bugs}  What bugs are already known?
  25. A.4.   @{" History              " link History}  What has happened?
  26. A.5.   @{" Credits              " link Credits}  Some regards
  27. B.     @{" Patches              " link Patches}  for PatchEditor
  28.  1995 Richard K
  29. rber - FreeWare - All Rights Reserved
  30. @EndNode
  31. @Node Kurz "SystemPrefs: 1. Short description"
  32. Nowadays, there are many tools to switch  the  caches  or  change  the
  33. custom  chip  settings.  But somehow, none of these tools satisfied my
  34. demands. I wanted a program that allows me to change the  settings  as
  35. comfortably  as  a preference editor, and after the bootup they should
  36. be set correctly.
  37. "SystemPrefs" is such a tool. It fits between  the  other  preferences
  38. editors,  and  a  small CLI program - inserted in the startup-sequence
  39. -handles the setup.
  40. @EndNode
  41. @Node Address "SystemPrefs: 2.1. Contact address"
  42. IMPORTANT: Please read the @{" copyright " link Copyright} note first!
  43. Write to the following address if you have questions or find a bug:
  44.     Richard K
  45.     Hornstra
  46.     51465 Bergisch Gladbach
  47.     Deutschland
  48.     E-Mail: r.koerber@tfh.dssd.sub.org
  49. You can check my WWW home page for the latest release or other stuff:
  50.     http://www.bg.bib.de/~a2h4ko
  51. Note that this page is currently in German and available until September
  52. 1996 only!
  53. PLEASE use the e-mail address if possible. If you use standard mail,
  54. please send DM 5 (or an equivalent amout of other currency) to cover
  55. the costs of my reply.
  56.   Support-Mailbox:
  57.     NOT ONLY FUN ...     ______
  58.   _L___________________  ____I~   T      ____________ ______________________
  59.    T~                / \\ T   T    | ___/Y          / Y   T~        /       /
  60.   T|    ____________/   \\|   |    | T   |      ___/  |   | _______/ ____  /
  61.   H|        \\  |   |     \\_  |    l_j   |   _   T    |   |        \\   | \\/
  62.   E|   _ ___/  l   |  _      |          |   T   |    l   l__      /  _l__
  63.    |    Y |        l_  \\     |          |   |   |        l_/     /       \\
  64.    |    | |         /  |\\    |    ___   |       |         /     /         \\
  65.    l____| l________/___j \\___j    T I___j_______j________/\\____/\\_________/
  66.    [*]=======================l____j==========[PRECiSiON-ADVERTISEMENT]===[*]
  67.          +49-2204-61630  ZyX 19.2
  68.          +49-2204-23856  ZyX 16.8
  69.          +49-2204-61499  HSTDS
  70.          +49-2204-23955  V32.b
  71.     24h online, prometheus mailbox system, SysOp: Kiwi
  72. Send me a small e-mail if you want to translate the  documentation  or
  73. the catalog file into your language.
  74. @EndNode
  75. @Node Copyright "SystemPrefs: 2.2. Copyright"
  76. SystemPrefs is 
  77.  1995 @{" Richard K
  78. rber " link SystemPrefs.pic/main} . All Rights Reserved.
  79. This program is FreeWare.
  80. This version of the program archive may be distributed freely as  long
  81. as  the  archive  remains  complete  and unchanged. You are allowed to
  82. charge a maximum fee of DM  8  (or  equivalent)  to  cover  all  costs
  83. including  media.  Otherwise  written  permission  from  the author is
  84. required.
  85. I permit including this archive in the Fred Fish  library  and  AmiNet
  86. and their CDs.
  87. The archive consists of the following files:
  88.  System                                The program itself
  89.  System.info                           Program icon
  90.  SystemPrefs-D.guide                   German documentation
  91.  SystemPrefs-D.guide.info              German documentation icon
  92.  SystemPrefs-E.guide                   This documentation
  93.  SystemPrefs-E.guide.info              Documentation icon
  94.  SystemPrefs-S.guide                   Swedish documentation
  95.  SystemPrefs-S.guide.info              Swedish documentation icon
  96.  SystemPrefs.pic                       Belongs to the guide files
  97.  Install                               Commodore Installer script
  98.  Install.info                          Installer script icon
  99.  c/SysPrefs                            The CLI setup tool
  100.  libs/provision.library                provision library
  101.  libs/reqtools.library                 reqtools library
  102.  catalogs/deutsch/SystemPrefs.catalog  The German catalog file
  103.  catalogs/svenska/SystemPrefs.catalog  The Swedish catalog file
  104. Usage for fascist or military purposes is FORBIDDEN!
  105. You are using this program "as is" and at your own  risk.  The  author
  106. (Richard  K
  107. rber)  is not responsible for any damanges, including (but
  108. not limited to) hard- or software damages or data loss.
  109. All rights reserved.
  110. Please delete this program and all related files if you do  not  agree
  111. with these copyright notes.
  112.     reqtools.library is 
  113.  Nico Fran
  114. ois. (Available on Fish Disks)
  115.     provision.library is 
  116.  Richard K
  117. rber.
  118.     AmigaGuide is 
  119.  Commodore-Amiga. (e.g. Fish Disk #920)
  120.     DraCo is 
  121.  MacroSystem.
  122. @EndNode
  123. @Node Install "SystemPrefs: 3. Installation and Program Start"
  124. AmigaOS 2.04 is required to use this program. locale.library should be
  125. installed if you want to take advantages of localization.
  126. SystemPrefs will be installed by the Commodore installer. First  start
  127. your  Workbench,  then the Installer script. You can use a floppy disk
  128. or hard drive as the destination.
  129. The prefs editor is copied  in  the  prefs/  drawer  and  the  startup
  130. program  is copied into C:. You have to change the startup-sequence so
  131. that  it   calls   the   startup   program   at   bootup.   Load   the
  132. "S:startup-sequence"  using  a  text  editor,  then  insert  the  line
  133. "SysPrefs >NIL:" right before the "IPrefs" line. After that,  you  can
  134. save the startup-sequence.
  135. The installation now completed.
  136. SystemPrefs can be started from Workbench by double-clicking its icon,
  137. or  from  the  shell.  The  shell  will  be released immediately after
  138. starting SystemPrefs and can  execute  further  commands  or  even  be
  139. closed.
  140. @EndNode
  141. @Node Cache "SystemPrefs: 4.1. CPU cache control"
  142. You can control the processor caches using  the  "CPU  cache  control"
  143. field.
  144.   Instruction Cache     Toggles the instruction cache. It should
  145.             normally be activated. Only self-optimizing
  146.             code could cause problems. (68020+)
  147.   Data Cache            Toggles the data cache. This one will normally
  148.             be activated. (68030+)
  149.   Instruction Burst     Toggles instruction burst. (68030)
  150.   Data Burst            Toggles data burst. This mode should normally
  151.             be turned off on Amiga 3000. (68030)
  152.   Write Allocate        A special bus mode. You can gain a little
  153.             more speed if you turn it off, but usually
  154.             your system will crash! Therefore, this gadget
  155.             is only available in expert mode. (68030-60)
  156.   Copyback              Only available on 68040. It gains more speed,
  157.             but some programs do not work correctly. Though
  158.             the OS is used to turn it on or off, on some
  159.             Amigas it is not possible to switch CopyBack
  160.             off.
  161.   VBR to Fast-RAM       With this gadget enabled, the processor's
  162.             vector registers are copied into Fast RAM.
  163.             This gains a (very) little more speed, but
  164.             causes lots of problems with games, demos
  165.             and some tools. (68010+, but not Draco)
  166.   Branch Cache          This is a new 68060's cache that predicts and
  167.             stores branches.
  168.   Superscalar           With this gadget enabled, the 68060's superscalar
  169.             modus will be activated.
  170.   Store Buffer          If this mode is enabled, the 68060 tries to join
  171.             multiple byte accesses to a longword access.
  172.   Half Inst Cache       This mode reduces the 68060's instruction cache
  173.             to half size, which is the size of the 68040's
  174.             cache.
  175.   Half Data Cache       This mode reduces the 68060's data cache to half
  176.             size, which is the size of the 68040's cache.
  177. The new settings will take effect after  you  exit  the  program  with
  178. "Save" or "Use".
  179. IMPORTANT!!! If you turn off Write Allocate, you should use the  "Use"
  180. gadget to check it out before saving settings. Make sure that there is
  181. no drive activity when you do this.
  182. IMPORTANT!!! Never change the VBR mode while Enforcer is running.  The
  183. system will hang for technical reasons!
  184. @EndNode
  185. @Node Ramsey "SystemPrefs: 4.2. RAMSEY control"
  186. With this field you control the RAMSEY chip built in  Amiga  3000  and
  187. Amiga 4000.
  188. There  must  be  RAMSEY version F installed, otherwise this group will
  189. be desactivated.
  190.   60ns-RAM              Puts RAMSEY into 60ns RAM access mode. This
  191.             mode is quite dangerous and is therefore
  192.             turned off by default. You can change it
  193.             only in expert mode.
  194. See the "60ns-RAM" chapter for more details.
  195. This mode is always desactivated on DraCo.
  196. WARNING: When changing this mode, your system may crash!
  197. @EndNode
  198. @Node CIA "SystemPrefs: 4.3. CIA control"
  199. This field controls the CIA modes:
  200.   Audio filter          Turns the audio filter (and the power LED)
  201.             on and off. On an Amiga 1000, this only
  202.             toggles the LED.
  203. This mode is always desactivated on DraCo.
  204. @EndNode
  205. @Node Menu "SystemPrefs: 4.4. The menus"
  206. The editor has the following menu items:
  207. Project
  208.   About...                      Some information about the program
  209.   System Info...                Some information about your system
  210.   Open...                       Opens a preference file
  211.   Save as...                    Saves a preference file
  212.   Quit                          Quits the preference editor
  213.   Reset To Defaults             Resets with the default settings
  214.   Last Saved                    Resets with the last saved settings
  215.   Restore                       Resets with the last used settings
  216.   Read Current Hardware         Sets with the current hardware
  217.                   status.
  218. Settings
  219.   Expert Mode                   Enables expert mode. Some critical
  220.                   parameters can then be changed.
  221.   Always Read Hardware          If this item is checked, the current
  222.                   hardware settings are used after
  223.                   launch, instead of stored settings.
  224. @EndNode
  225. @Node RAM60ns "SystemPrefs: 5. The 60ns RAM mode"
  226. The 60ns RAM mode lets RAMSEY make fast RAM accesses with 60ns  access
  227. time,  whereby  your  system  will gain up to 10% more speed! However,
  228. your fast RAM must be designed for 60ns RAM accesses for this mode  to
  229. work.
  230. The  tolerances of some 70ns SIMMs are high enough. You have to try it
  231. out (your Amiga cannot usually be damaged by this experiment).
  232. Turn the 60ns RAM mode on and press "Use" (you cannot undo  a  "Save"d
  233. configuration  easily  if  this  experiment fails!). Make sure that no
  234. harddisk and disk accesses occur if you press "Use"!
  235. If your Amiga crashes immediately or does not work reliably, your  RAM
  236. is  too slow for this mode. You should leave it turned off or buy 60ns
  237. RAM. If this experiment fails, you should switch off your Amiga for  a
  238. few seconds, because 60ns RAM mode survives a simple reset.
  239. Otherwise,  you seem to be a lucky owner! Anyway, you should test your
  240. Amiga for a while before you store this mode using "Save".
  241. @EndNode
  242. @Node FAQ "SystemPrefs: A.1. FAQ"
  243.  The system crashes during bootup and cannot be restarted with a
  244.   reset after that.
  245.     You have activated the 60ns RAM mode and saved this setting,
  246.     but your RAM is not fast enough. Switch your Amiga off
  247.     and on. Press both mouse buttons to get to the early
  248.     boot menu and start your workbench without executing the
  249.     startup-sequence. Now, enter the following line into the
  250.     shell: "delete envarc:sys/system.prefs" and reboot.
  251.  After I plugged more SIMMs in my Amiga, the 60ns mode does not
  252.   work any more.
  253.     This is normal! You have to turn this mode off!
  254.  Using the 60ns-RAM mode, my system crashes sometimes/permanently.
  255.     If you do not use 60ns RAM in the internal RAM banks, the
  256.     RAM accesses are out of the tolerance time of your SIMMs.
  257.     You should buy some 60ns RAM or leave this mode turned off.
  258.  The 60ns-RAM mode has no effect.
  259.     This mode only works in conjunction with a RAMSEY
  260.     chip Version F, used only in some Amiga 3000s and the AGA
  261.     machines.
  262.  The system crashes if I turn off Write Allocate mode.
  263.     This mode very seldom works, and usually gains no speed.
  264.     Better leave it turned on.
  265.  The burst modes have no effect.
  266.     Because of a construction fault in the Amiga 4000, the
  267.     burst modes do not gain any speed. :-(
  268.  The Copyback mode has no effect.
  269.     The cobyback mode only works on a 68040. Use with an
  270.     Amiga 4000 does not gain much speed.
  271.  I cannot turn off the Copyback mode.
  272.     This is a fault of the OS, since SystemPrefs uses the appro-
  273.     priate OS call only.
  274.  Since I set VBR to fast RAM, some players, games and demos crash.
  275.     This is the side effect of this function. Some demos, games
  276.     and music players write directly to the vector registers
  277.     without checking the VBR. If you have trouble with this
  278.     mode, then turn it off or use tools like "RunLame".
  279.  How can I get the highest speed out of my Amiga?
  280.  68020,68030: Turn on all cache and burst modes
  281.  68040:       Turn Copyback on
  282.  68060/DraCo: Turn on branch cache, superscalar and store buffer
  283.  Set VBR to fast RAM (68010+)
  284.  Enable 60ns RAM (buy 60ns RAM if necessary)
  285.  Turn off Write-Allocate (if possible)
  286. @EndNode
  287. @Node Improve "SystemPrefs: A.2. Improvements"
  288. I plan the following improvements for my next release:
  289.  External cache switching (does anybody REALLY need this?)
  290.  ROM -> fast RAM
  291.  ARexx port
  292.  Commodity support
  293.  ToolType support
  294. Please do NOT consider this list as obligatory.
  295. @EndNode
  296. @Node Bugs "SystemPrefs: A.3. Known bugs"
  297. SystemPrefs was tested on the following Amigas:
  298.  A4000/o3o (MMU,FPU) , Kick 3.0 ,10 MB RAM (8F/2C), 1GB HD,
  299.              Fastlane, MaestroPro, CyberVision 4MB
  300.  A4000/o3o (MMU,FPU) , Kick 3.0 , 6 MB RAM (4F/2C), 400MB HD,
  301.              Emplant, MaestroPro
  302.  A3000/o3o (MMU,FPU) , Kick 3.1 ,10 MB RAM (8F/2C), 1,4GB HD,
  303.              MaestroPro, CyberVision 4MB
  304.  A4000/o3o           , Kick 3.0 , 6 MB RAM (4F/2C), 261MB HD
  305.  A500/ooo            , Kick 2.04, 3 MB RAM (2F/1C), 42MB HD,
  306.              GVP Series II host adapter
  307.  DRACO/o6o
  308. These bugs are currently known:
  309.  An Enforcer hit occures after startup from Shell. It is harmless, but
  310.     it will be hard work to correct it...
  311. @EndNode
  312. @Node History "SystemPrefs: A.4. History"
  313. V3.4    
  314.  Released on 1995-11-06
  315.  Bugfix: on 68060 based systems, "68040" was displayed as FPU
  316.  Swedish translation [Staffan Palmroos]
  317. V3.3    
  318.  Released on 1995-10-26
  319.  Bugfix: Fastmode couldn't be changed [Andreas Goiczyk,
  320.       Raphael Pilarczyk, Ralf Hochheiden]
  321. V3.2    
  322.  Released on 1995-10-14
  323.  Removed an enforcer hit that occured on startup [Henning
  324.       Friedl]
  325.  By mistake, VBR was always moved, even if not necessary
  326.       [Henning Friedl]
  327.  DraCo: 68040 based DraCo is supported now
  328.  Implemented a System Info requester
  329.  "Always read hardware" implemented
  330. V3.01   
  331.  Released on 1995-07-21
  332.  Removed bug in the 68060 CACR read routine
  333.  68060's half cache size implemented
  334.  Rearranged cache buttons
  335. V3.00   
  336.  Released on 1995-07-11
  337.  68060 support
  338.  DRACO support
  339.  Removed bug in ProVision: window did not open if proportional
  340.       font had been used.
  341.  Window is font sensitive
  342.  Gadgets without function will be desactivated
  343.  Improved hardware set routines
  344. V2.20   
  345.  Released on 1995-06-18
  346.  Window position is stored
  347.  No more error requesters if config file could not be opened
  348. V2.15   
  349.  Released on 1995-05-14
  350.  Crashed when a library was missing
  351.  Using PhxLnk
  352. V2.11   
  353.  Released on 1995-03-23
  354.  English translation of the German docs
  355. V2.10   
  356.  Released on 1995-02-09
  357.  VBR -> fast RAM added
  358. V2.00   
  359.  Released on 1995-02-06
  360.  Localized (English, German)
  361.  AmigaGuide documentation written
  362. V1.47   
  363.  Released on 1994-06-05
  364.  Font-sensitive GUI
  365. V1.21   
  366.  Released on 1994-04-21
  367.  Expert Mode included
  368.  Filter can be toggled
  369. V1.00   
  370.  Released on 1994-04-11
  371.  Cache and FastMode switchable
  372. @EndNode
  373. @Node Credits "SystemPrefs: A.5. Credits"
  374. I wish to thank...
  375. Sven Arke                       for his support with his mailbox
  376. Henning Friedl                  from MacroSystem for his kind support
  377.                 (68060 and Draco)
  378. Rodney Hester                   for his correction of my English
  379.                 translation (a really hard job ;)
  380. Staffan Palmroos                for his translation into the Swedish
  381.                 language (thanks!)
  382. Frank Wille                     for the best Amiga assembler
  383.                 (PhxAss!)
  384. Dietmar Eilert                  for GoldEd
  385. Nico Fran
  386. ois                   for reqtools.library
  387. Amiga Technologies GmbH         for the near Amiga revival! You're
  388.                 doing a great job, guys! :-)
  389.         _
  390.      _ //
  391.      \\X/   -- Amiga -- Motorola Inside... --
  392. @EndNode
  393. % I love my "girl friend" :-)
  394. % IMPORTANT NOTE to translators: The following two words "Localization" and
  395. % "Process name" must be English! Don't translate this lines!
  396. @Node Patches "SystemPrefs: D. Patches"
  397.   You can change the following parameters using "PatchEditor"
  398. (available from my support mailbox):
  399. Localization            Turns localization on or off. If off, System
  400.             Prefs uses the built-in language (English)
  401.             only. Default: on
  402. Process name            Name of the program (default "SystemPrefs")
  403.   Note that you are not allowed to distribute a program that has been
  404. modified by PatchEditor.
  405. @EndNode
  406.